home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / zgetf2.z / zgetf2
Text File  |  1996-03-14  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. ZZZZGGGGEEEETTTTFFFF2222((((3333FFFF))))                                                          ZZZZGGGGEEEETTTTFFFF2222((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ZGETF2 - compute an LU factorization of a general m-by-n matrix A using
  10.      partial pivoting with row interchanges
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE ZGETF2( M, N, A, LDA, IPIV, INFO )
  14.  
  15.          INTEGER        INFO, LDA, M, N
  16.  
  17.          INTEGER        IPIV( * )
  18.  
  19.          COMPLEX*16     A( LDA, * )
  20.  
  21. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  22.      ZGETF2 computes an LU factorization of a general m-by-n matrix A using
  23.      partial pivoting with row interchanges.
  24.  
  25.      The factorization has the form
  26.         A = P * L * U
  27.      where P is a permutation matrix, L is lower triangular with unit diagonal
  28.      elements (lower trapezoidal if m > n), and U is upper triangular (upper
  29.      trapezoidal if m < n).
  30.  
  31.      This is the right-looking Level 2 BLAS version of the algorithm.
  32.  
  33.  
  34. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  35.      M       (input) INTEGER
  36.              The number of rows of the matrix A.  M >= 0.
  37.  
  38.      N       (input) INTEGER
  39.              The number of columns of the matrix A.  N >= 0.
  40.  
  41.      A       (input/output) COMPLEX*16 array, dimension (LDA,N)
  42.              On entry, the m by n matrix to be factored.  On exit, the factors
  43.              L and U from the factorization A = P*L*U; the unit diagonal
  44.              elements of L are not stored.
  45.  
  46.      LDA     (input) INTEGER
  47.              The leading dimension of the array A.  LDA >= max(1,M).
  48.  
  49.      IPIV    (output) INTEGER array, dimension (min(M,N))
  50.              The pivot indices; for 1 <= i <= min(M,N), row i of the matrix
  51.              was interchanged with row IPIV(i).
  52.  
  53.      INFO    (output) INTEGER
  54.              = 0: successful exit
  55.              < 0: if INFO = -k, the k-th argument had an illegal value
  56.              > 0: if INFO = k, U(k,k) is exactly zero. The factorization has
  57.              been completed, but the factor U is exactly singular, and
  58.              division by zero will occur if it is used to solve a system of
  59.              equations.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.